home *** CD-ROM | disk | FTP | other *** search
/ Windows Expert / Windows Expert.iso / utility / winpoem.zip / WINPOEM.TXT < prev   
Text File  |  1992-04-06  |  4KB  |  104 lines

  1. WinPoem 1.0
  2. -----------
  3.  
  4. by Julian Smart
  5. ---------------
  6.  
  7. Fancy a little intellectual stimulation after long hours spent staring
  8. at spreadsheets or reports?  Does your brain long for something a little
  9. more fulfilling than Tetris or fiddling with the WIN.INI file?  Then you
  10. could go out and buy a poetry book... or alternatively, if you just
  11. can't drag yourself away from the screen, click on the WinPoem icon.
  12.  
  13. WinPoem is a simple Windows application which picks poems from a file at
  14. random, or finds poems according to a string criterion, and formats them
  15. nicely in a window.  A displayed poem can be copied to the clipboard
  16. ready for inclusion in that more imaginative report...
  17.  
  18. It's small, it's free and it's totally harmless, so far as I know.
  19. No responsibility accepted, though, for any problems it might cause with
  20. your setup.
  21.  
  22. Files
  23. -----
  24.  
  25. The main data file is winpoem.dat, and an index file winpoem.idx is
  26. supplied or can be (re)built using the Compile menu option.  Source code
  27. for Borland C++ is provided in an archive called poem-src.zip
  28.  
  29. Use
  30. ---
  31.  
  32. Simply run the program, and a random poem will be displayed.  The
  33. simplest way of operating WinPoem is to keep pressing the space bar for
  34. new poems (or pages for multi-page poems).
  35.  
  36. Clicking the right mouse button (or selecting the WinPoem Options menu
  37. item from the system menu) gives a choice of the following facilities:
  38.  
  39. Next poem/page   (Page down)   Display next poem (or next page)
  40. Previous page    (Page up)     Display previous page (multi-line poems only)
  41. Copy to clipboard              Allows poems to be pasted into other applications
  42. Search           (S)           Allows user to enter a search string
  43. Next match       (N)           Gives next search match
  44. Font                           Change font to Roman, Swiss etc.
  45. Bigger text                    Increases text size
  46. Smaller text                   Decreases text size
  47. Compile index                  Use if you have edited the data file
  48. About                          About WinPoem
  49. Exit             (Esc)         Quit WinPoem
  50.  
  51. When WinPoem is closed, the font, text height and window position are
  52. remembered (stored in WIN.INI) for next time.
  53.  
  54. WinPoem can be put on the run= line in WIN.INI, so that a random poem
  55. will pop up every time Windows is run.  If started in iconized state,
  56. e.g. by putting it on the load= line, double-clicking on the icon will
  57. pop up a random poem.
  58.  
  59. The data file
  60. -------------
  61.  
  62. The winpoem.dat file contains poems separated by a #, with optional
  63. @ codes denoting title (@T) author (@A) and page break (@P).  Any
  64. unrecognized codes will cause the rest of the line to be ignored, so
  65. the user can add lines (e.g. @S for subject) which will be searched on but
  66. not displayed.
  67.  
  68. The data file contains a mixture of 20th century and earlier poetry,
  69. subject to copyright constraints.  Apologies if any copyrights have
  70. inadvertently been infringed, though I have tried to avoid it.
  71.  
  72. Implementation
  73. --------------
  74.  
  75. The program is my `Windows learning application', i.e. a vehicle for
  76. getting stuck into Windows programming, whilst (possibly) affording
  77. others a modicum of amusement.  As such, the source may be of more use
  78. to some people than the executable.  It builds on fragments from
  79. Borland's whello.cpp example and Petzold's `Programming Windows', plus
  80. hints from various sources taken from the CICA archive.
  81.  
  82. For what it's worth, WinPoem demonstrates the following concepts (though
  83. not necessarily very well):
  84.  
  85. Drawing icons, changing text fonts, formatting text, intercepting
  86. keystrokes, drawing on memory bitmaps and blitting them to the screen
  87. for slicker redrawing, popup menus, changing the system menu, faking a
  88. 3D effect, using an error log (I didn't use a debugger!), using a
  89. resource file, writing to and reading from WIN.INI, modal dialog boxes,
  90. copying text to the clipboard, random file access.
  91.  
  92. License
  93. -------
  94.  
  95. Copyright Julian Smart, released into the public domain, April 1992. Any
  96. comments, suggestions for improvements, or alternative poetry data files
  97. welcome - it would be nice to have a poem pop up that I didn't type in!
  98.  
  99. Julian Smart
  100. 149 Warrender Park Road
  101. Edinburgh
  102. EH9 1DT
  103. jacs@aiai.ed.ac.uk
  104.